<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="../book.css" charset="ISO-8859-1" type="text/css">
<title>Preferences</title>
</head>
<body>
<h1>Preferences</h1>
<p>
    The preferences dialog is accessed via the <span class="menu">Window &gt; Preferences </span> menu
    option. The SVN options are located under the Team node in the navigation
    tree.
</p>
<h2>SVN</h2>
<h3><img src="../images/preferences-svn.png" width="643" height="532"> </h3>
<h3>General SVN Settings</h3>
<dl>
    <dt>Show revision comparisons in a dialog</dt>
    <dd>
    This setting launches the revision comparison in a dialog.</dd>
    <dt>Select unversioned resources on commit</dt>
    <dd>
        <span class="action">Check</span> this setting to have SVN automatically
        select all unversioned resources in your <a href="glossary.html">working
        copy</a> when performing a commit operation. 
    </dd>
    <dt>Fetch affected paths on demand</dt>
    <dd>
        This setting affects the History view.  Checking this option tells SVN
            to only get the list of changed items for a revision when you
            click on it. This may make the initial list retrieval a little
            faster and also uses less memory, particularly if you have some revisions
            with thousands of changed items
.    
    </dd>
    <dt>Show tags in remote history view </dt>
    <dd>
    Checking this option will cause SVN to show
        tag information when browsing history directly from the repository.
        On a slow connection you probably would not want to do this.
    </dd>
    <dt>Default number of log messages</dt>
    <dd>
    Specify the number of log messages to retrieve from the repository when viewing
        log history. An entry of zero (0) will tell SVN to retrieve all of the
        available log messages.
</dd>
    </dl>
<h3>    SVN Interface</h3>
<p>
    This setting controls whether SVN should utilise the JavaHL (JNI) or SVNKit
    (Pure Java) interface when communicating with the SVN repository.
</p>
<h3>    Configuration location</h3>
<p>
    This setting specifies where the SVN configuration file is located.
    Select either the default location or 
an alternative location by pressing the <span class="control">Browse</span> button.
</p>
<h2>    Console</h2>
<p>
<img src="../images/preferences-svn-console.png" width="643" height="532"></p>
<p>
    The SVN plug-in for Eclipse can display the SVN commands, messages and error
        information in the Eclipse Console. This 
    screen allows you to control the colors that are used in the Console for
SVN output.
</p>
<dl>
    <dt>Console text color settings</dt>
    <dd>
        Colors can be chosen for three distinct Console outputs. These are command
        line, messages and error 
        notifications. To change a color, click on the colored button next to
        the desired console output 
    type and select a new color.    
    </dd>
    <dt>Show SVN output in the Console View</dt>
    <dd>
        Check this box if want to have SVN messages sent to the Eclipse
            console.
    </dd>
    <dt>Bring SVN output to front on error</dt>
    <dd>
        Checking this option will force the Console tab to the front when SVN
            writes an error 
    message to the Console.
</dd>
</dl>
<h2>Diff/Merge</h2>
<p>
<img src="../images/preferences-svn-diff.png" width="653" height="532"></p>
<p>
    This setting allows you to specify whether you want to use the merge program
    supplied with the Eclipse platform or an external merge program. 
</p>
<p>
    For external
        merge programs, you can pass a number of special parameters:
</p>
<dl>
    <dt>base</dt>
    <dd>
    the original file without your changes</dd>
    <dt>theirs</dt>
    <dd>
    	the file as it is in the repository</dd>
    <dt>yours</dt>
    <dd>
        the file as it is in the repository
    </dd>
    <dt>merged</dt>
    <dd>
    the conflicted file, where to merge</dd>
</dl>
<h2>    Label Decorations</h2>
<p>
<img src="../images/preferences-svn-dec-text.png" width="653" height="532"></p>
<h3>    Text</h3>
<p>
    These settings control how the SVN plug-in for Eclipse will decorate files,
    folders and project text labels. A complete 
    list of available substitution variables and their meaning can be obtained
    by clicking <span class="control">Add Variables</span>. An 
    example of how the decorated item will be shown is displayed beneath the
configured item.</p>
<dl>
    <dt>File Format</dt>
    <dd>
        Specify the variables you would like SVN to use when decorating
        files listed in your<br>
project directories.</dd>
    <dt>Folder Format</dt>
    <dd>
    Specify the variables you would like SVN to use when decorating project
    folders.
    </dd>
    <dt>Project Format</dt>
    <dd>
        Specify the variables you would like SVN to use when decorating
            your project.
    </dd>
</dl>
<p>
    Additional text labels can be specified for outgoing, added and external
    files in your projects too.
</p>
<h3>    Icons</h3>
<p>
    <img src="../images/preferences-svn-dec-icons.png" width="427" height="235">
</p>
<p>
    These settings allow you to configure certain icon decorators within the
SVN plug-in for Eclipse.</p>
<dl>
    <dt>Indicate is outgoing</dt>
    <dd>
    A locally modified, versioned file.
    </dd>
    <dt>    Indicate has remote</dt>
    <dd>
    A local, versioned file that is not modified.
    </dd>
    <dt> Indicate is added</dt>
    <dd>
    A file has been marked for addition but has not yet been committed.
    </dd>
    <dt> Indicate is new resource</dt>
    <dd>
    An unversioned file.    
    </dd>
</dl>
<h3>    General</h3>
<p>
    <img src="../images/preferences-svn-dec-general.png" width="427" height="212">
</p>
<p>
    Check this setting to have the SVN plug-in for Eclipse drill down through
    your project directory structures to determine 
the decorator to use at the folder level.
</p>
<p>
    <img src="../images/bullet-warn.png" width="75" height="16" align="left">    Uncheck this setting if you experience poor decorator performance in Eclipse.
</p>
<p class="tasks">
    Related Tasks
</p>
<p>
    None
</p>
<p class="reference">
    Related Reference
</p>
<p>
    <a href="configure-tags.html">Configuring branches and tags</a> 
</p>
</body>
</html>